Класс LocalConnection

Доступность

Flash Player 6.

Описание

Класс LocalConnection позволяет SWF роликам обмениваться данными без обращения к fscommand() или JavaScript. Объекты LocalConnection могут взаимодействовать только с SWF файлами, запущенными на том же самом компьютере, не взирая на то, принадлежат ли они одному приложению — например, SWF файл, запущенный в браузере и SWF файл, работающий в проекторе. Вы можете использовать объекты LocalConnection и для передачи данных в пределах одного ролика, но это нестандартное использование; все примеры в данном разделе демонстрируют возможности взаимодействия разных SWF файлов.

Основными методами для отправки данных являются LocalConnection.send() и LocalConnection.connect(). Даже в самом простейшемс лучае ваш код будет содержать использование этих методов; учтите, что как LocalConnection.send(), так и LocalConnection.connect() используют одно имя соединения, lc_name:

// Код в SWF файле-получателе
this.createTextField("result_txt", 1, 10, 10, 100, 22);
result_txt.border = true;
var receiving_lc:LocalConnection = new LocalConnection();
receiving_lc.methodToExecute = function(param1:Number, param2:Number) {
  result_txt.text = param1+param2;
};
receiving_lc.connect("lc_name");

// Код в SWF файле-отправителе
var sending_lc:LocalConnection = new LocalConnection();
sending_lc.send("lc_name", "methodToExecute", 5, 7);

Наиболее простой способ использования объекта LocalConnection состоит в обмене данными между объектами LocalConnection в роликах, находящихся в одном домене. Однако, если вам необходимо реализовать взаимодействие между роликами из разных доменов, необходимо выполнить ряд действий. Для более подробной информации смотри описание параметра connectionName в разделах LocalConnection.send(), LocalConnection.allowDomain и LocalConnection.domain().

Обзор методов класса LocalConnection

Метод	Описание
`LocalConnection.close()`	Завершает соединение объекта LocalConnection.
`LocalConnection.connect()`	Готовит объект LocalConnection к получению данных, отправленных методом `LocalConnection.send()`.
`LocalConnection.domain()`	Возвращает строку, содержающую над-домен данного ролика.
`LocalConnection.send()`	Вызывает метод удаленного объекта LocalConnection.

Обзор обработчиков событий класса LocalConnection

Обработчик события	Описание
`LocalConnection.allowDomain`	Вызывается, когда объект LocalConnection получает запрос на выполнение метода от другого объекта LocalConnection.
`LocalConnection.allowInsecureDomain`	Вызывается, когда объект LocalConnection, чей SWF файл находится в ролике, загруженном по защищенному протоколу (HTTPS), получает запрос от объекта LocalConnection, чей SWF файл загружен по незащищенному протоколу (HTTP).
`LocalConnection.onStatus`	Вызывается при отправке сообщения объектом-отправителем объекту-получателю.

Конструктор класса LocalConnection

Доступность

Flash Player 6.

Синтаксис

new LocalConnection() : LocalConnection

Параметры

Нет.

Возвращает

Ссылку на объект LocalConnection.

Описание

Конструктор; создает объект LocalConnection.

Пример

В следующем примере показано, как создаются объекты LocalConnection в ролике-отправителе и ролике-получателе. Ролики могут использовать одно или различные имена для объекта LocalConnection. В данном примере используются различные имена.

// Код в SWF файле-получателе
this.createTextField("result_txt", 1, 10, 10, 100, 22);
result_txt.border = true;
var receiving_lc:LocalConnection = new LocalConnection();
receiving_lc.methodToExecute = function(param1:Number, param2:Number) {
  result_txt.text = param1+param2;
};
receiving_lc.connect("lc_name");

Данный SWF файл отправляет запрос предыдущему SWF файлу.

// Код в SWF файле-отправителе
var sending_lc:LocalConnection = new LocalConnection();
sending_lc.send("lc_name", "methodToExecute", 5, 7);

См. также

LocalConnection.connect(), LocalConnection.send()

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление